Overview

In the Architecture Overview, we took a look at the different components that make up the Euclid Unified Liquidity layer. In this section, we will be looking at each of the Euclid smart contracts and their respective messages.

Since the Factory smart contract is the only entry point for users/projects to interact with the Euclid layer, we will be providing a breakdown of the execute messages as well as the queries. For the rest of the contracts, no messages can be called directly on them so we are only interested in the available queries.

Common Types

A list of structs that are used in many of our contracts.

PairWithDenom

Specifies a token pair. The name and type for each token is specified.

pub struct PairWithDenom {
    pub token_1: TokenWithDenom,
    pub token_2: TokenWithDenom,
}

{
  "pair_with_denom": {
    "token_1": {
      "token": "token-1-id",
      "token_type": {
        "Native": {
          "denom": "native-denom-1"
        }
      }
    },
    "token_2": {
      "token": "token-2-id",
      "token_type": {
        "Native": {
          "denom": "native-denom-2"
        }
      }
    }
  }
}

Field	Description
token_1	Information about the first token.
token_2	Information about the second token.

TokenWithDenom

Specifies information on one token. The name of the token and type is specified.

pub struct TokenWithDenom {
    pub token: Token,
    pub token_type: TokenType,
}

Field	Description
token	The name of the token.
token_type	Type of the token (native or smart).

Token

pub struct Token(String);

TokenType

Whether the token in native or CW20.

pub enum TokenType {
    Native { denom: String },
    Smart { contract_address: String },
}

Variant	Fields	Description
Native	denom: String	Native token with a denomination.
Smart	contract_address: String	Smart contract token with contract address.

Pair

The token Id for each token in a token pair.

pub struct Pair {
    pub token_1: Token,
    pub token_2: Token,
}

Name	Type	Description
token_1	Token	Id of the first token in the pair.
token_2	Token	Id of the second token in the pair.

CrossChainUserWithLimit

Struct that defines a user address and limit on a specified chain. Used to define the amount of funds an address on a specific chain should receive.

pub struct CrossChainUserWithLimit {
    pub user: CrossChainUser,
    pub limit: Option<Uint128>,
}

"cross_chain_addresses":{
        "user": {
              "chain_uid": "chainA",
              "address": "comso1..."
                },
        "limit": "500"
    }

Field	Type	Description
user	CrossChainUser	Information on the cross chain user including the address and chain UID.
limit	Option<Uint128>	An optional limit to the amount of asset to be received by the user address. Will take the maximum amount if not specified.

CrossChainUser

The chain UID and address of the user.

pub struct CrossChainUser {
    pub chain_uid: ChainUid,
    pub address: String,
}


pub struct ChainUid(String);

Field	Type	Description
chain_uid	ChainUid	The unique identifier of the chain.
address	String	The address of the user on the chain.

Pagination

Struct used to define pagination parameters.

pub struct Pagination<T> {
    pub min: Option<T>,
    pub max: Option<T>,
    pub skip: Option<u64>,
    pub limit: Option<u64>,
}

"pagination": {
  "min": "3",       
  "max": "15",      
  "skip": 2,       
  "limit": 10       
    }

Field	Type	Description
min	T	The lower limit value, used to filter results. Type depends on the type of Id used.
max	T	The upper limit value, used to filter results. Type depends on the type of Id used.
skip	u64	Number of results to skip from the result set. Defaults to 0 if not specified.
limit	u64	Maximum number of results to return. Defaults to 10 if not specified.